home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Magazine / CDRipping / Normalize / normalize.doc < prev    next >
Encoding:
Text File  |  2001-01-31  |  5.6 KB  |  200 lines

  1.  
  2.  
  3.  
  4. NORMALIZE(1)                                         NORMALIZE(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        normalize - adjusts volume levels of audio files.
  9.  
  10.  
  11. SSYYNNOOPPSSIISS
  12.        nnoorrmmaalliizzee [options] [--] file [...]
  13.  
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        nnoorrmmaalliizzee is used to adjust the volume of wav audio files
  17.        to a standard volume level.  This is useful for things
  18.        like creating mp3 mixes, where different recording levels
  19.        on different albums can cause the volume to vary greatly
  20.        from song to song.
  21.  
  22.        nnoorrmmaalliizzee operates in two phases.  In the first phase, it
  23.        analyzes the specified files as wav audio files, and com-
  24.        putes the volume of each file.  In the second phase, it
  25.        applies a volume adjustment to each file to set each
  26.        file's volume to a standard level.
  27.  
  28.        As a special case, the filename "-" will cause nnoorrmmaalliizzee
  29.        to read audio data from standard input.  The data is
  30.        assumed to be 44.1 kHz, 16 bit, stereo PCM data (i.e.
  31.        without a WAV header).  If standard input is specified as
  32.        a file, the --nn option is implied.
  33.  
  34.  
  35. OOPPTTIIOONNSS
  36.        --aa, ----aammpplliittuuddee=_A_M_P_L_I_T_U_D_E
  37.            Adjust the RMS volume to the target amplitude AMPLI-
  38.            TUDE; must be between 0.0 and 1.0.  The default is
  39.            0.25.
  40.  
  41.        --bb, ----bbaattcchh
  42.            Enable batch mode: see BBAATTCCHH MMOODDEE, below.
  43.  
  44.        --mm, ----mmiixx
  45.            Enable mix mode: see MMIIXX MMOODDEE, below.  Batch mode and
  46.            mix mode are mutually exclusive.
  47.  
  48.        --gg, ----ggaaiinn=_G_A_I_N
  49.            Skip the volume computation phase, and don't compute
  50.            the volume adjustment from the current volumes of the
  51.            files.  Instead, just apply the given gain as a volume
  52.            adjustment to the files.  As a plain number this is
  53.            just a multiplier applied to all samples, If a number
  54.            suffixed by "dB" is specified, all volumes are
  55.            adjusted by that many decibels.
  56.  
  57.        --hh, ----hheellpp
  58.            Display usage information and exit.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NORMALIZE(1)                                         NORMALIZE(1)
  71.  
  72.  
  73.        --nn, ----nnoo--aaddjjuusstt
  74.            Compute and output the volume adjustment that would
  75.            set the volume to target, but don't apply it to any of
  76.            the files (i.e. skip the second phase).  If you use
  77.            this option, your files will not be altered in any
  78.            way.
  79.  
  80.        --qq, ----qquuiieett
  81.            Don't output progress information.  Only error mes-
  82.            sages are printed.
  83.  
  84.        --tt, ----tthhrreesshhoolldd=_T_H_R_E_S_H_O_L_D
  85.            In batch mode (see BBAATTCCHH MMOODDEE, below), when averaging
  86.            volume levels, throw out any volumes that are more
  87.            than THRESHOLD decibels from the average.  A high
  88.            value here (say, 50) will make sure that the volumes
  89.            of all files are considered in the average.
  90.  
  91.        --vv, ----vveerrbboossee
  92.            Increase verbosity.  This option can be repeated for
  93.            more messages.
  94.  
  95.        --VV, ----vveerrssiioonn
  96.            Print version information and exit.
  97.  
  98.  
  99. MMIIXX MMOODDEE
  100.        This mode is made especially for making mixed CD's and the
  101.        like.  You want every song on the mix to be the same vol-
  102.        ume, but it doesn't matter if they are the same volume as
  103.        the songs on some other mix you made last week.  In mix
  104.        mode, average level of all the files is computed, and each
  105.        file is normalized to this average volume.
  106.  
  107.  
  108. BBAATTCCHH MMOODDEE
  109.        When operating on a group of unrelated files, you usually
  110.        want all of them at the same level, and this is the
  111.        default behavior.  However, a group of music files all
  112.        from the same album is generally meant to be listened to
  113.        at the relative volumes they were recorded at.  In batch
  114.        mode, all the specified files are considered to be part of
  115.        a single album and their relative volumes are preserved.
  116.        This is done by averaging the volumes of all the files,
  117.        computing a single adjustment from that, and applying the
  118.        same adjustment to all the files.  Some analysis is also
  119.        done so that files with volumes that appear to be statis-
  120.        tical aberrations are not considered in the average.  This
  121.        is useful if you have albums (like many of the author's)
  122.        in which there is one "quiet song" that throws off the
  123.        average.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NORMALIZE(1)                                         NORMALIZE(1)
  137.  
  138.  
  139. BBUUGGSS
  140.        If excessive clipping occurs when applying a volume
  141.        adjustment to a file, a warning is printed but the adjust-
  142.        ment is still applied.  The only way around this currently
  143.        is to back up unrecoverable files before running nnoorrmmaalliizzee
  144.        (which you should probably do anyway).
  145.  
  146.        The French message translations are very bad.  Apologies
  147.        to French speakers for my high school French plus
  148.        babelfish translations.
  149.  
  150.  
  151. AAUUTTHHOORR
  152.        Chris Vaill <cvaill@cs.columbia.edu>
  153.        Compiled under Amiga by Fr3dY <fr3dy@retemail.es>
  154.  
  155. SSEEEE AALLSSOO
  156.        ssooxx((11))
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                                                 3
  198.  
  199.  
  200.